home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / WINDOWS / MUSICLIB.ARJ / MUSICLIB.TXT < prev    next >
Text File  |  1992-08-09  |  10KB  |  268 lines
  1.  
  2.  
  3.                          The Music Librarian
  4.                              Version 2.0
  5.                            August 9th, 1992
  6.  
  7.                                  by
  8.  
  9.                           Edward A. A. Mahon
  10.                       200 Parkway St., Apt. #105
  11.                          Kingston, Ontario
  12.                                Canada
  13.                               K7M  3E6
  14.  
  15.       _________  _ /| /\ |\                 ___________________________
  16.      / _______/ / / |  / | \    /\         /                          /
  17.     / /        / /| | -- |  \  /  \       / mahon@Software.Mitel.COM /|
  18.    / ----/    / /_| |    | \ \/ /\ \     /__________________________/ / 
  19.   / /        / /  | |    | |\__/  \ \    |__________________________|/
  20.  / /________/ /   |_|    |_|       \ \   /##//###//##//###//##//###//
  21. /_______⌐ Edward ┼▓ Mahon 1991-1992 \_\ /==========================/
  22.  
  23.  
  24. ***********************************************************************
  25. ************************* General Information *************************
  26. ***********************************************************************
  27.  
  28.  
  29. The Music Librarian is a tool for music media management.  The
  30. main window consists of five listboxes: category, alphabet index,
  31. artists, releases, and tracks.
  32.  
  33. Category Listbox - Musical categories.
  34. Alphabet Listbox - Artist index for the current category.
  35. Artist ListBox - Selected artist(s) for catagory index.
  36. Release Listbox - Selected artist's release(s).
  37. Track Listbox - Selected release's track(s).
  38.  
  39. The distributed program consists of 4 files:
  40.  
  41. MusicLib.exe
  42.    - The executable.
  43. MusicLib.ima
  44.    - The Actor image.  This file must be in the same directory as
  45.      the executable.
  46. MusicLib.txt
  47.    - This file.  If this file is in the same directory as the
  48.      executable, selecting 'Help General' opens it in Notepad.
  49. Sample.mlb
  50.    - Sample library file to get started.
  51.  
  52.  
  53. ***********************************************************************
  54. ************************* Program Information *************************
  55. ***********************************************************************
  56.  
  57.  
  58. ******************************
  59. ****** Standard Editing ******
  60. ******************************
  61.  
  62. This section describes shortcuts for standard editing features which
  63. are consistent for artists, releases, tracks, and categories where
  64. applicable.
  65.  
  66.  
  67. - Cut/Copy/Paste -
  68.  
  69. Each element type is saved independent of other dissimilar elements
  70. for these editing functions.   For example, a copied track does not
  71. affect the last copied artist.
  72.  
  73. Element's cannot be transferred between windows
  74.  
  75.  
  76. - New -
  77.  
  78. An element may be added by selecting '<element> New' from the menu,
  79. tabbing to the corresponding listbox and pressing <Insert>, or
  80. holding the 'Shift' key while clicking the left mouse button on
  81. the corresponding listbox.
  82.  
  83. If the element already exists, the user is informed and prompted
  84. for confirmation before replacing the existing entry.
  85.  
  86. *NOTE* Replacing an existing entry causes all associated elements
  87.        of that entry to be lost.
  88.  
  89.  
  90. - Edit -
  91.  
  92. An element may be edited by selecting '<element> Edit' from the
  93. menu, tabbing to the corresponding listbox and pressing <Enter>,
  94. or double clicking the left mouse button on the corresponding
  95. listbox.
  96.  
  97.  
  98. - Delete -
  99.  
  100. An element may be deleted by selecting '<element> Delete' from the
  101. menu, tabbing to the corresponding listbox and holding the <Shift>
  102. key while pressing <Delete>, or clicking the right mouse button on
  103. the corresponding listbox.
  104.  
  105. Deleted elements are saved for a susequent 'Paste'.  Each element
  106. type is saved independent of other dissimilar elements.  For
  107. example, a copied track does not affect the last copied artist.
  108.  
  109.  
  110. - Copy -
  111.  
  112. An element may be copied by selecting '<element> Copy' from the
  113. menu, or tabbing to the corresponding listbox and holding the
  114. <Ctrl> key while pressing <Insert>.
  115.  
  116.  
  117. - Paste -
  118.  
  119. An element may be pasted by selecting '<element> Paste' from the
  120. menu, or tabbing to the corresponding listbox and holding the
  121. <Shift> key while pressing <Insert>.
  122.  
  123. *NOTE* Replacing an existing entry causes all associated elements
  124.        of that entry to be lost.
  125.  
  126.  
  127. ******************************
  128. ****** Search Features *******
  129. ******************************
  130.  
  131. Element 'Search' features match any occurence of a string in the
  132. respective target field  (excluding 'Relese Media' which uses pre-
  133. defined values).  String searches are not case sensitive.
  134.  
  135. Example:
  136.     A 'Year' search for '198' would contain all releases for 1980-1989.
  137.  
  138. Each search generates a new library and window, provided a match
  139. is made.  Modifications to search libraries do NOT affect the main
  140. library.
  141.  
  142. Windows created via a search feature are automatically tagged as
  143. modified.
  144.  
  145. The '<element> Search' feature, combined with the 'File Merge'
  146. feature, allows filtered libraries to be created based on multiple
  147. criteria.
  148.  
  149. Example:
  150.     Search criteria: All releases in the 1980's and 1990's having
  151.                      the word 'music' in the title on a compact
  152.                      disc media.
  153.  
  154.     Steps:
  155.        1. Select 'Release Year' from the main window's menu.
  156.              Search string = 198
  157.              Result -> new window (198.MLB) created containing all
  158.                        realeases for 1980 - 1989
  159.        2. Select 'File Save' from the 198.MLB window's menu.
  160.        3. Select 'Release Year' from the main window's menu.
  161.              Search string = 199
  162.              Result -> new window (199.MLB) created containing all
  163.                        realeases for 1990 - 1999
  164.        4. Select 'File Merge' from the 199.MLB window's menu.
  165.              File specification -> 198.MLB
  166.              Result -> contents of 198.MLB merged with 199.MLB
  167.        5. Select 'Release Search' from the 199.MLB window's menu.
  168.              Search string = music
  169.               Result -> new window (MUSIC.MLB) created.
  170.        6. Select 'Release Media' from the MUSIC.MLB window's menu.
  171.              Select 'Compact Disc' from the media search dialog.
  172.              Result -> new window (MEDIA.MLB) created.
  173.  
  174.  
  175. ******************************
  176. ************ File ************
  177. ******************************
  178.  
  179. The file functions available are: New, Open, Merge, Save, Save As,
  180. Print, and Exit.  The 'Merge' feature allows two library files to
  181. be combined (see 'Search Features' above). 
  182.  
  183. Upon completion of the first Music Librarian session, the following
  184. line is added to 'WIN.INI'.
  185.  
  186. [MusicLibrarian]
  187. File = <path\name of last opened library file>
  188.  
  189. Prior to exiting the application, the 'File' key is updated with
  190. the complete path and name of the last opened library file.  This
  191. file name is appended to the 'File' menu each time the application
  192. is started.  Selecting it causes the file to opened and loaded
  193. automatically.
  194.  
  195. The 'File Metrics' feature presents a dialog indicating the current
  196. library's dimensions (number of artists, releases, and tracks).  If
  197. the same artist is specified in two different categories, it is only
  198. counted once.  A release of multiple medias is counted once for each
  199. media type.  This is also reflected in the track count.
  200.  
  201. Selecting 'File Exit', or 'Exit The Music Librarian' from the sytem
  202. menu, will prompt for the saving of any open library windows which
  203. have been modified.  Selecting 'Cancel' at any prompt during this
  204. phase cancels the exit request. 
  205.  
  206.  
  207. ******************************
  208. ********** Category **********
  209. ******************************
  210.  
  211. This 'Category' menu selection provides standard editing features
  212. for categories, as well as the ability to rename.
  213.  
  214. The 'Category Metrics' option presents a dialog indicating the current
  215. category's dimensions (number of artists, releases, and tracks).  A
  216. release of multiple medias is counted once for each media type.  This
  217. is also reflected in the track count.
  218.  
  219.  
  220. ******************************
  221. *********** Window ***********
  222. ******************************
  223.  
  224. The 'Window' menu selection presents a list of open Music Librarian
  225. windows.  Selecting a window activates it, bringing it to the top.
  226.  
  227.  
  228. ******************************
  229. ************ Help ************
  230. ******************************
  231.  
  232. 'Help General' displays this file if it is located in the same
  233.  directory as the executable.  Otherwise, a general help dialog
  234.  is displayed.
  235.  
  236. 'Help Mouse' explains the mouse commands.
  237.  
  238. 'Help Comments' explains how to send comments and suggestions to me.
  239.  
  240. 'Help Garfield 'n' Hobbes'  Let's just say I've spent some time on
  241. this *puppy* for a good reason...
  242.  
  243.  
  244. ***********************************************************************
  245. *************************** Technical Stuff ***************************
  246. ***********************************************************************
  247.  
  248. Version 2.0 is backwards compatible.
  249.  
  250. The database is saved as a simple text file.  I didn't see any
  251. need to complicate things...
  252.  
  253. A backup file (.MBK) is automatically created before saving over
  254. an existing file.
  255.  
  256. The default name of the libarary file resulting from a search is
  257. the string searched for (up to a maximum of the eight characters,
  258. with spaces replaced by underscores).  The exception to this is
  259. a release media search (the resulting library is untitled).
  260.  
  261. A command line library path/file may be specified when defining
  262. the program in Program Manager's 'File New Program Item' or 'File
  263. Properties'.  This causes the file to automatically loaded on
  264. invocation (if it exists).
  265.  
  266. Thanks for checking it out!
  267.  
  268. Ed Mahon